home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr41 / dmp252.zip / DMP.DOC < prev    next >
Text File  |  1993-06-08  |  9KB  |  202 lines
  1.  
  2.  
  3.                 DMP.DOC
  4.  
  5.          Documentation for the Dual Module Player v2.51
  6.  
  7.           Copyright (C) 1992,1993 Otto Chrons
  8.  
  9.  
  10.  DMP.EXE is  a program    demonstrating the  capabilities of the DSMI
  11.  programming interface (DSMI stands for Digital Sound & Music
  12.  Interface). It's a standalone module  player with  which  you can play
  13.  STM (also S3M,669) files  as well  as Amiga modules (MOD or NST). DMP is
  14.  freeware so you  can freely distribute  it and I hope you did, as long
  15.  as you include this help file with the executable.
  16.  
  17.            Here is the command line syntax:
  18.  
  19.            DMP [options] [modulename] [@listfile] [options]
  20.  
  21.            Where:
  22.            ------
  23.        modulename : name of a module (wildcards *,? allowed)
  24.        listfile   : name of a file containing list of module names
  25.  
  26.        options  : -Sxxxx          set sampling rate 4000-44100
  27.                       alternatively 4-44
  28.               -H or -?          show help screen
  29.               -Ix          interrupt number
  30.               -Pxxx          port address (use 42 for PC speaker)
  31.               -Dx          DMA channel
  32.               -O          Scramble module order
  33.               -L          Inhibit looping
  34.               -M          Mono mode (SB16 & PAS)
  35.               -Q          Quality mode (on 8-bit cards only)
  36.               -Cx             Desired card where x is:
  37.                     1 for Sound Blaster
  38.                     2 for Sound Blaster Pro
  39.                     3 for PAS+
  40.                     4 for PAS16
  41.                     5 for SB16
  42.                     6 for general DAC (Covox,PC speaker)
  43.                     7 for Aria cards
  44.               -Txxx          Buffer size xxx (0-32000)
  45.               -E          Disable extended tempos (MOD only)
  46.               -Axxx          Amplify by xxx, 31 is normal volume
  47.               -B          Disable EMS usage
  48.               -8          Force an 16-bit card into 8-bit
  49.                       mode (works with Aria and PAS16)
  50.               -Nxx          Set default panning to xx (0-63)
  51.  
  52.  If you use some options all the time, you can put them into an
  53.  environment variable DMP:
  54.  
  55.     Example:
  56.  
  57.  You always want to use quality mode and sampleing rate of 22kHz and
  58.  mono mode, put following line into your AUTOEXEC.BAT
  59.  
  60.     SET DMP=-q -s22 -m
  61.  
  62.  NOTE!    You cannot override single letter options (-l,-o,-m,-q) with
  63.  command line parameters. All other options can be overriden.
  64.  
  65.  You may have to  give your soundcard's IRQ  number and/or port address
  66.  if DMP fails to find them. If you don't provide both values then DMP
  67.  will assume 220h for port address, and 7 for interrupt number. Giving
  68.  wrong address    will hang  your machine,  but wrong interrupt number
  69.  only stops the playing after a second. The "/C" option is useful if you
  70.  want to use some other card, than the one DMP automatically detects.
  71.  
  72.  You don't  have  to add  any extension  to  the name,  because the
  73.  program will try  extensions AMF, STM, 669, S3M, MOD and  NST if it
  74.  doesn't find the file. Note that you can supply many modulenames and
  75.  list files, up to the internal limit of 1024 modulenames.
  76.  
  77.        Example:
  78.  
  79.        DMP beyond -s20 *.NST @goodmods
  80.  
  81.        goodmods is a text file containing following lines:
  82.        occ-san
  83.        stars
  84.        intro3
  85.  
  86.  DMP  will use    the  sampling  rate  of  20KHz    and  play following
  87.  modules: BEYOND.MOD,  OCC-SAN.STM, STARS.MOD, INTRO3.MOD  and all
  88.  .NST-files in the current directory.
  89.  
  90.  
  91.                 How to use DMP
  92.  
  93.  After DMP has    loaded the first  module, it starts  to play it and
  94.  shows some information about  it. DMP displays module's  name, its file
  95.  size, the amount of  memory used for module and sampling rate.  Because
  96.  of the AMP's Intelligent Module Loader  (IML) modules  usually take
  97.  10-30% less  space. I've  seen a 244Kb module shrink into 151Kb when I
  98.  loaded it with DMP. While playing, DMP updates fields showing current
  99.  pattern, row, elapsed time, volume and sampling rate. Under these
  100.  fields are four lines showing the current status of the corresponding
  101.  tracks. Here is an example:
  102.  
  103.  ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
  104.    bassdrum            │ F#2 │ 64 │               │ ■■■■■■■■■■■■■■■■■■■■■
  105.    strings7            │ D-3 │ 20 │ ARPEGGIO      │ ■■■■■■■■■■■■■■■
  106.    guitar42            │ E-2 │ 12 │ PORT.NOTE     │ ■■■■■■■■■■■
  107.    guitar44            │ G-2 │ 57 │ FINE VOL      │ ■■■■■■■■■■■■■■■■■■
  108.  ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  109.  
  110.  The first  field shows  the instrument  currently playing  on that
  111.  track. Second is the note value, third its volume and fourth indicates
  112.  what special command is running. The bar simulates a VU  meter on music
  113.  equipment, but you shouldn't take it  as  an exact  representation of
  114.  the music  level, it's there because it looks nice!
  115.  
  116.  The rest of the screen is filled with instrument names. The numbers before an
  117.  instrument name indicate the channels that instrument is playing on.
  118.  
  119.  Pressing 'H'  bring up a  quick-help showing  command line options and
  120.  keys used to control the program.
  121.  
  122.            Keys :
  123.           ────────
  124.  
  125.        P        pause module, any key resumes
  126.        1-9        turn track xx on/off
  127.        0        turn selected track on/off
  128.        D        DOS shell (write EXIT to get back)
  129.        N        load next module (if you have supplied more than one)
  130.        S        stereo mode on/off (SB Pro), default is on
  131.        F        filter on/off (SB Pro), default is off
  132.        left/right    Jump to next/previous pattern
  133.        up/down    select track
  134.        F1-F10,+,-    set volume
  135.        [,]        Set new speed
  136.        {,}        Set new tempo
  137.        (,)        Add/remove channel
  138.        V        Real/fake volume bars
  139.        , .        Panning left/right
  140.        H        Help screen
  141.        ESC        exit
  142.  
  143.  Try this module player  with all the modules  you have, and if you
  144.  encounter problems with any modules, inform the author. Have fun.
  145.  
  146.  
  147.                ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
  148.                 Contacting the author
  149.                ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  150.  
  151.        ┌─────────────────────────────────────────────────────────────────────┐
  152.        │                                                                     │
  153.        │   By mail:                                                          │
  154.        │   ────────                                                          │
  155.        │                                                                     │
  156.        │            Otto Chrons                                              │
  157.        │            Pyydyspolku 5                                            │
  158.        │            SF-36200 Kangasala                                       │
  159.        │            FINLAND                                                  │
  160.        │                                                                     │
  161.        │   Fidonet:                                                          │
  162.        │   ─────────                                                         │
  163.        │        2:222/348.10                         │
  164.        │   SBC-net:                                                          │
  165.        │   ─────────                                                         │
  166.        │        14:1510/500.10                         │
  167.        │                                                                     │
  168.        │   InterNet:                                                         │
  169.        │   ──────────                                                        │
  170.        │            c142092@cc.tut.fi (fastest method to contact)            │
  171.        │                                                                     │
  172.        └─────────────────────────────────────────────────────────────────────┘
  173.  
  174.     Newest version is always available at:
  175.  
  176.        ┌─────────────────────────────────────────┐
  177.        │ R.A. LAW      +358-37-49007    24h     │
  178.        │ Moonlight shadow +358-0-3882575   24h     │
  179.        │ POP              +358-18-550136   24h   │
  180.        └─────────────────────────────────────────┘
  181.  
  182.     See CABINET.DMP for a list of DMP support sites in Finland.
  183.  
  184.     See DMP.REV for revision history.
  185.  
  186.                 ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
  187.                  For programmers only
  188.                 ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  189.  
  190.  
  191.  DMP was  created with    Borland C++  3.1 and  it is  based on DSMI's
  192.  routines, so by ordering DSMI interface you could write programs with
  193.  similar capabilities. DSMI is a collection of    routines (for C and
  194.  Turbo Pascal) that allows programmers to play    modules in the
  195.  background, but unlike any other module player it also allows
  196.  simultaneous sound effects!! Up to 32 channels can be used which means
  197.  that you can have a module and sound effects playing in full stereo (on
  198.  cards which support stereo sound)! DSMI is available and the price is
  199.  270FMK ($70). Packet includes full documentation (printed), OBJ files &
  200.  libraries for C version, TPUs for Turbo Pascal and also some of the
  201.  source code so you can modify the behaviour of DSMI.
  202.